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translating^ or distributing this software in any unauthorized maiifiiHrf 
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OVERVIEW 

Clang! Clang! Cro-o-o-o-ak! Beep! Beep! 

Rattle» rattle^ rattle* VtlMBm&mcmi 

SOUND EDITOR lets you take advantage of the ATARI computer's sound generation capabilities* 
This is a joystick-driven # graphical proflram for creating and modifying short sounds* It's mit 
apprc^riate for developing tunes» jinglesr W lounds U^ing longer than one second* 

SOUND EDITOR uses a graphical approach* It divides a one-second sound into two voices* These 
voices correspond to two of the four sounii channels in the SOUND command of ATARI BASIC* 
Working with one voice at a time* you specify three parameters^ which correspond to the three 
other variables of the SOUND command* volume, frequency (corresponding to SOUND'S "pitch"), 
and distortion* For each parametert SOUND EDITOR displays a box containing 20 discrete dots* 
Each dot represents «05 seconds of your sound* You a joysti^ controller to position the 
value for each *05-second segnwit* Tour positioned dots form a visual plot of the parameter* 

You can play your new sound at any time and then modify it* You can also stor# your, sounds on 
cassette or diskette and recaLll them later* In addition« you c^mi merge a stwict^^v^^kiai^^^m^ a 
RAM-resident voice* 

Creating these sounds is fun and instructive in itself* Butt to make SOUND BDITOR even more 
useful* we've included in these user instructionn a, program ti^ iets you inccHf^^ your 
OPttations into your BASIC programs* 

These user instructions and SOUND EDITOR'S plot parameters assume familiarity with the SOUJJD 
command and with the hanlwar# a^iKts of produdlng sounds on ATARI Personal Compilers* See 

pages 57 - 58 of the BASIC REFERENCE MANUAL * 1980 (Part No* CO15307 REV* 1) for an 
explanation of the SOUND command* See the ATARI Personal Computer Systems Hardware Manual* 
1930 (Part No* CO 16555) for disucssions of the POIOKt cMp (pp* 11*23 - IX#25> and AUDIO (pp* 
111*12 - III*14)* 

REQUIRED ACCESSORIES 

16K RAM for cassette version 
24K RAM for ATARI 810 diskette version 
ATARI BASIC Language Cartridge 
ATARI 410 Program Recorder for cassette 
ATARI 810 Disk Drive for diskette 
ATARI Joystick Controller 
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SETTING UP 

1« Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your computer* 

2* Plug your joystick controller into the first controller jack on your computer console* 

3* If vou have the cassette version of SOUND EDITOR ? 

a* Insert the SOUND EDITOR cassette in the program recorder^ press REHIND» and then press 
PLAY* 

b* Type CLOAD and press RETURN twice* 

c« After the cassette loads into RAM> you'll see the READY prompt* Type RUN and press 
RETURN* 

If vou have the diskette version of SOUND EDITOR } 
a* Turn on your disk drive and insert the SOUND EDITOR diskette* 
b* Fdwer up your computer and turn on your video screen* 

c» At the READY prompt, type RUN "DtNOISY" and press the RETURN key* If you're using more 
than one disk drive, remember to follow the device initial (D) with the number of the 
drive containing the diskette (e*g*» RUN "D2*NOISY" for disk drive two)* The program will 
load into RAM and start* 
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THE FIRST DISPLAY SCREEK 



The following information then displays* 



ATARI 800 NOISE CREATION 

COPYRIGHT 1981 ATARI 

This will allow 20 ^mlxmmt frequency 
and con'trol values to be written to 2 

audio channels during a one second ^ 
'play'* Sounds May be saved on diskt- 
You Must have a 4iaM«tick in 4#c^k 1 
(the left Jack) to use thli^^^ 

L -> Load and Save will do disk I/0| 
S -> Merge allows single voice loads* 
R -> Rotate changes paraMeter being 

altered ♦ 

V 'v'oice chooses one of two voices* 
P -> Play will play once J ContinuoM* 

♦ - - 

will p^iay until stopped <C>* 
H -> Hex will update the hexadecimal 

tables of values to be written* 
0 -> Off will turn off all smjind* 



— press upon any 

Figure !♦ First Display Screen 



This display screen lists the eight, one-letter commands you use to perform various 
activities^ These eight commands also display at the top of the three work screens (one screen 
for each parameter)* To use these commands* type their first letter* For examplet press P to 
play back your somd* Pressing the RETUHH key isn't necessary («»pt when you respond to 
command prompts)* Descriptions of these commands appear later in the COMMANDS section* 
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INTRODUCTION 

You use your joystick controller to position dots within a control box to create and edit your 
soundSf and you type the one-letter commands to work with your sounds in various ways* You may 
mix joystick and letter commands as needed* You can create one-voice or two-voice sounds* 



WORK SCREENS 

SOUND EDITOR uses three work screenst one for each parameter* You do all work on these screens 

with your joystick controller* The work screen for the first parameter* FREQUENCY, looks 
roughly as follows ("#" represents the flashing cursor indicating your current position and 
shows the initial default values you replace with your own)* 



(1) 
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The first line (1) of the work screen lists the commands for quick recall* Whenever you use 
one of these commands» any prompts for user input associated with the activity will display in 
this line* (See the discussions in the COMMANDS section for command prompts*) 
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Along the left-hand side of the display screen — beginning at (2) — are the values you use to 
plot each parameter* Arrows point to the parameter currently displayed > in this case FREQUENCY 
Therefore, these values are for the FREQUENCY work screen* Other parameter values display 
here for CONTROL and VOLUME work sorfens* 

On the right-hand side of the display screen is tlie control box in which you plot your values 
for the parameter* The flashing cursor (3) always indicates your current position in the box* 
Each "dot" (*) represents one segment (1/20) of a one-second sound* Replace the initial 
default values by positioning the |l#shing cursor vertically above or below a segment so that 
it aligns with the desired value mt the left and then pressing the red button* Continue in 
this manner for each segment* The current voice displays to the right of this box (4)* 

At the bottom of the screen are tte three sound parameters (5 - 7) and their current 
hexadecimal values for each segment* (Use the Hex (H) command whenever you want to update this 
information*) ""''-^ 



CREATING A SOUND 

There is no predetermined order of steps by which you create a sound« One ^proach is as 

Working with one voice at a time> use your joystick controller to position your desired values 
for a parame^ter* Recall that the flashing cursor indicates your current position within the 
^ boxf and arrows at the bottom of the display screen point to the parameter you're currently 
working with* ( Note * SOUND EDITOR sets up initial default values for each of the three 
parameters, and you see the plot of these values* To create your sound* replace these values 
with your own*) Thus, for voice 0, first ypu plot the 20 dots for FREQUENCY by positioning the 
flashing cursor in the area of the box opposite the value you want to assign that segment and 
then pressing the red button* Continue in this way until you have all 20 segments plotted for 
frequency* 

To try cHit your sound at any point, press P for a single playbadi &r C f&r continuous playback 
(press O, or move your joystick, or press the red button on your joystick to stop the 
playback)* ( Note * SOUND EDITOR plays both voices by default whenever you use the P or C 
command • To turn off one vmce teoyiorarily » plot the VOLUME sepnents to 0 for ttm ymm you 
want to eliminate*) 

When you're ready to work on the next parameter, type R to rotate to the distortion (labeled 
CONTROL) work screen* You then position these 20 dots in the same way* When you play back your 
sound, youll now hear both your distortion values and your frequency values* (Your sound will 
still use the default volume values until you plot your own*) Thus, you always hear the 
cumulative effect of your sound when you play it back* Next, rotate the display screen to 
VOLUME and plot these 20 segments* 

» 

When youVe ready to turn to the second voice, type V* You'll see the VOICE 1 display for the 
^ same work screen as you last worked on* Repeat the same sequence to plot the three parameters 
for your second voice* 

Another approach to creating a two-voice sound might be to plot one parameter at a time for 

the two voices* Once you're satisfied with the combination, you then go on to the next 
parameter* 
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MERGING A SAVED VOICE WITH A VOICE IN MEMORY 

Suppose you want to combine a voice you've just created and have in memory* with a voice you 
have saved on tape or disk* To combine these voices* use the Load command* This command lets 
you assign each voice a different number at the time you merge them* This feature gets around 
the problem of your having assigned the same voice number to the RAM-resident voice and the 
saved voice* Nhen you type Lf a prompt asks you whether you want to merge a RAM-resident voice 
with a saved voice or erase your RAM-resident sound and load a saved sounds 

To merge voices to form new sounds* you'll need to keep track of the file names or tape 
locations of your sounds* A short description of each voice for a sound will also help you 
with future mergers* See the discussion under the LOAD command for more information* 
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Following is a summary of the function of each comcnand* together with its promptst Remember to 
press the RETURN key after artsv^iHring prompts* 

LOAD (L) 

Use this command to load sounds you've saved on ftiskAtte or ttSMttet Hhen you type L* 
the command line prompts! 

LOAD- DevrFilen :? 

Respond by specifying the device ori Which you stored your sound (also specify the name of 
your file if you stored your sound on disk)* For example* type C* if you're loading from 
cassette* making sure your tape counter is set to the location at which you recorded your 
sound* If you stored your file on diskette^ enter both the device code (and niMiber if 
you're using other than disk drive one) and the file name (e*g*» D2JWEIRD to load a file 
named WEIRD from disk drive two)* 

The jOimfiMd line then pro^ 

Type an 'M' to wer^e voices 

Tou iieve t«iK3 choices* (1) you can erase both yotr RAM-resident voices and load in another 
soundt or (2) you can merge a voice saved as part of a sound on cassette or diskette with 

one of your RAM-resident voices* To erase and replace your RAM-resident sound* respond to 
this prompt by typing any letter except M* SOUND EDITOR will replace your RAM-resident 
sound (both voices) with your specified jtowd from cassette or diskette* To merge a saved 
voice with a RAM-resident voic»» type M* You then sei^the prompt* 

Enter Source Voice * ♦? ? - 

Enter the number of the voice (0 or 1) you want SOUND EDITOR to load in* For example^ to 
load VOICE Ot type p* Finallyi you'll see the prompt J 

Enter Destination Moice * ? 41 

Enter the number (0 or 1) you want SOUND EDITOR to assign to the voice it loads* Thus, if 
you want SOUND EDITOR to assign your VOICE 0 as VOICE 1 in RAM, then type 1. SOUND EDITOR 
erases your current VOICE 1 and loads in your specif ied vmGe as the new VOICE 1 * You now 
have a new sound! 

SAVE (S) 

Use this command to save a sound you've created* SOUND EDITOR automatically saves both 

voices* Keep a record of which voice contains which parts of your sound for future 
reference* When you type Sf you see the prompt* 

SAVE- DevtFiian IT 



If you change your mind# press RETURN to cancel the command* Otherwise* enter your device 
code (and file name for a sound saved on diskette) the same way youj^ecify a^ile^o 



load it* (If you save your sound on tape^ remember to cue the tape to the proper location 
and to press the PLAY and RECORD buttons*) 

PLAY (P) 

Use this asmmand to play back your sound one time* SOUND EDITOR plays both voices 
simultaneously» using default values for any parameters you haven't set yet* 

CONTINUOUS (C) 

Use this command to play back your sound repeatedlyt until you press O or move your 
joystick* 

ROTATE (R) 

Use this command to rotate the work screen until it displays your desired parameter* When 
you first enter SOUND EDITOR^ the first work screen to display is FREQUENCY* Enter R to 
rotate to the CONTROL work screent and type R again to rotate to the VOLUME work screen* 
Enter R another time to rotate back to the FREQUENCY work screen, and so on* 

VOICE (V) 

Use this command to change voices* If you're currently working with VOICE 0, typing V 
causes SOUND EDITOR to display the same work screen for VOICE 1* If youYe currently 
working with VOICE 1» typing V causes SOUND EDITOR to display the same work screen for 
VOICE 0* 

OFF (O) 

If the final segment of VOLUME is not zero* then your sound will rmt stop automatically* 

Use this command to turn off all sound that SOUND EDITOR is currently generating* 

HEX (H) 

Use this command to update the hexidecimal display at the bottom of a work screen so that 
this information reflects the current values you've positioned in the control box* The 
hex display gives you a numerical equivalent of your voice parameter segments should you 
need this information for programming purposes* Nith this command you can avoid 
time-consuming calculations for what might be a transitory value* 
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Here are two programs for incorporating the sounds you create into your BASIC programs* Both 
programs do the same thing» but they do it differentlyt Program I uses the SOUND command and 
thus is much easier to understand* However » it uses more memory because it needs an extra 
array* Program II uses POKESi which eliminate an array# but makes it harder to understand* 

Use these programs by incorporating them into your BASIC programs as subroutines* Both 
programs load from whatever file you specify (or they load from tape if you so specify) in 
line 20: OPEN #l,4,0,"D:filename" for diskette or OPEN #1,4,0,"C:" for cassette* The first 
portion of the program (lines 20-65) load the control arrays} place these lines anywhere prior 
to ccdling the sound* Lines 20 - 65 contain the sound play subroutine} owing to BASIC'S method 
for finding subroutines and FOR/NEXT loops* it's best to place these lines as close to the 
beginning of your program as possible* (That is* if your subroutine is buried deep in your 
program^ it may diange your sound's timing somewhat)* 



PROGRAM I 

> 5 REM XJKTHIS PROGRAM ALL^S YOU TO ymym 

6 REM )IC)ICUSE SOUNDS CREATED WITH THE*)* 

7 REM :«>KSQUND EDITOR IN YOUR BASIC «>k 

8 REM MM PROGRAMS mm 

9 REM MM )iC)icLOAD SOyND)K3ic >ic)ic 

10 DIM FREQ(^) ,CTROL(^0 ) ,k;OL(^0 ) 

15 F-OR I:=l TO ^0?FREQ(I):=0:CTROL(I):=:0 JUOL(I).:=0 JNEXT I 
20 OPEN *l,4,0,"Drfilenane" #r OPEN *lr^rOr'*Ci*' 
25 FOR I=:l to 40 

3 0 ge::t # 1 , x : freq ( i > ==x 

^0 GET #1 ,X:CTROL(I)=X 
50 GET #1 tY:VOL(I>«Y 
60 NEXT I 
65 CLOSE #1 

69 REM )K>K)KPLAY SOUND>k)K)jc 

70 FOR J=:l TO 20 

80 SOUND 0tFREQ( J) tCTROL< J) ,MOL<L) 

85 SOUND 1,FREQ( Jf20) ,CTROL( J+20) ,UOL( J+20) 
9 0 NEXT J 
100 GOTO 70 
110 END 



PROGRAM II 



5 REM )iC5icTHIS PROGRAM ALLOWS YOU TO xjk 

6 REM >k:«USE SOUNDS CREATED WITH THE:«« 

7 REM >k:4<S0UND EDITOR IN YOUR BASIC 

8 REM HOK PROGRAMS 

9 REM )iC)ic 5ic)KL0AD S0UND5iC)K )K5IC 

10 DIM FREGH^O ) ,PLAY(^IO ) 

15 FOR 1=1 TO 'lO JFREQ<I)=:0 :PLAY(I):=0 :NEXT I 

20 OPEN *1^4,0,"D:f ilenawe" — or OPEN *1^4,0,"CJ 

25 FOR I«l TO ^0 

30 GET #1 ,X:FREQ<I)=X 

^0 GET #1,X 

50 GET #1,Y 

55 PLAY<I)«Y+X5ic6 

60 NEXT I 

65 CLOSE #1 

69 REM 5iC)iC5icPLAY SOUND5iC3iC5ic 

70 FOR J=:l TO 20 

80 POKE 53760 ,FREQ( J) tPOKE 53761 , PLAY ( J ) 

85 POKE 53762^FREQ< J-f20) :P0KE 53763,PLAY< J+20 ) 

90 NEXT J 

100 GOTO 70 

110 END 
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PROGRAM OPERATION WARNINGS AND LIMITATIONS 



The flashing cursor must be present in the control box before you can enter a command or 

change a segment value* Sometimes SOUND EDITOR takes several seconds to execute a command and 

replace the cursor* 

If SOUND EDITOR refuses to accept your commands even though the flashing cursor is present in 
the control box and your joystick control works fine^ you might have accidentally pressed the 
CAPS/LOWER key and are in Ipwerca^e mode* Press CAPS/LOWER while holding down the SHIFT key to 
reset to uppercase mode* 

To obtain the best results from SOUND EDITOR requires some patience* It isn't easy at first to 
translate the graphical representation of the sound or the hexidecimal notation* After some 
practice and experimentation, however, you'll start noticing a correlation between the hex 
notation and the work screen* Then you're on your way to iMstoi^ tte^^9^ capabilities of 
the ATARI computer via SOUND EDITOR! 
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You might want to expand SOUND EDITOR to support all four voices (sound channels)* It will run more 
slowly if you do and it will take some programming work^ but an intermediate programmer should be 
able to write the codet To play all four channels at oncet you'll need to POKE the array values 
into locations 53764 - 53767 in the same way as in lines 710 - 720 of the SOUND EDITOR program* 
You'll also need to change the control functions to account for the additional input* And third, 
you'll need to change the BASIC subroutines to accept four voices as follows* (1) double the length 
of the arraysf (2) OPEN another file to handle the input from the new voices« (3) append this input 
to the end of the existing arrays or DIMension new ones* and (4) change the output routine to play 
the extra elements* 
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j^VIEW FORM 




We're interested in your experiences with APX programs and documentation » both favorable and 
unfavorable* Many software authors are willing and eager to improve their programs if they know 
what users want« Andt of course» we want to know about any bugs that slipped by uSf so that the 
software author can fix them* Ne also want to know whether our documentation is meeting your needs* 
You are our best source for suggesting improvements! Please help by taking a moment to fill in this 
review sheet* Fold the sheet in thirds and seal it so that the address on the bottom of the back 
becomes th#«i^elope fronts 

1* Name and APX numbir of isrogram - . 

2* If you have problems using the program* please describe them here* 



3* What do you especially like about this program? 




4* What do you think the program's weaknesses are? 



5* How can the catalog description be more accurate and/or comprehensive? 



6* On a scale of 1 to 10* 1 being "poor" and 10 being "excellent"* please rate the following 
aspects of this program* 

Easy to use ~ 

User-oriented (e*g*t menus* prappts* clear language) 

Enjoyable 

Self-instructive 

Useful (for non-game software) 

Imaginative graphics and sound 




7* Describe any technical errors you found in the user instructions (please give page numbers) 



* 



3» What did you especially like about the user instructions? 



9* What revisions or additions would improve these instructions? 



10» On a scale of 1 to 10» 1 representing "poor" and 10 representing "excellenff how would you 
rate the documentation and why? 



11# Other comments about the software or the user instructions^ 



I I 
ISTAMPI 

I I 



ATARI Program Exchange 

O* Box 427 
155 Moffett Park Drive 
Sunnyvale, CA 94086 
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